Domain CHHOLDER Request

Function

This request is used to change the domain holder(s). You may add new holders and / or remove existing ones.

Requirements

The request can only be processed if the domain exists and is administered by the RegAcc that submits the request.

Features

  • When a domain is transferred to a new domain holder within the framework of a CHHOLDER, all AuthInfo entries stored for this domain will become invalid.
  • If a domain is subject to an active DISPUTE, the domain holder can only be changed (CHHOLDER) if the mandatory data for the holder remains unaltered.
  • If new name servers are specified for a CHHOLDER request and the predelegation check fails for this, the request is rejected with an "error" and the owner data is not changed.

Verification

  • A domain CHHOLDER order automatically triggers a risk assessment.

  • Domain CHHOLDER is also executed when contacts without/with telephone number or e-mail are to be changed.

  • During the process implementation, additional messages may appear for domain CHHOLDER if deadlines are set.

Request Parameters

A CHHOLDER request is composed of the "Domain" data object fields and some other parameters, which are described below:

K/V Keyword XML Namespace and Element Occurrence
min - max		 Type / Length Value Range Description
Action domain:chholder 1 enumeration chholder-erule This is the request type.
Version - 1 enumeration version-erule This is the version. The keyword is only relevant for requests in the key/value format.
CtId ctid 0 - 1 token
3 - 64		 Any visible Unicode character (according to Unicode version 3.1 This is the unique transaction ID which is issued by the client.

Common Mistakes

The domain stated in the request does not exist.

 

Examples

Copy

request:domainCHHOLDER
format:kv

Version: 5.0
Action: chholder
ctid: cba-9345345321
Domain: de-example.de
Holder: DENIC-1000002-MAX
Generalrequest: DENIC-1000002-GENERAL
Abusecontact: DENIC-1000002-ABUSE
nserver: ns1.xn--de-xample-x2a.de 
nserver: ns2.de-example.de 81.91.170.12
nserver: ns2.de-example.de 2001:608:6:6:0:0:0:11
dnskey: 257 3 8 AwEAAcoFUSyg1mkE5c33q8UbDiRZx5+/QtqFjVcyTEdv7YBYp9UnqrbXr7g4p8aDMI0ZuN4M8bxlPz+ItVfWO71rSkcxK1HwqmH4Pi1vSM3L6uYqZopEG9gJLqNpBBmzR29iSwR86TdnGUJ21Jfagc/+9xk3xmtdzNK3ROUcn/f8yiBN
Copy

response:domainCHHOLDER
status:connect
format:kv

Result: success
INFO: 53000080013 Domain "Status" is "connect"
INFO: 16350000040 Verification information must be provided for the holder(s) to avoid dedelegation by [2024-12-09T15:45:01+01:00]
INFO: 16350000041 Verification information must be provided for the holder(s) to avoid deletion by [2024-12-16T15:45:01+01:00]
Stid: 57ebbb10-9590-11df-a9e2-9519b5688882
Ctid: cba-9345345321
Copy

response:domainCHHOLDER
status:serverHold
format:kv

Result: success
INFO: 53000080015 Domain "Status" is "serverHold"
INFO: 16350000041 Verification information must be provided for the holder(s) to avoid deletion by [2024-12-16T15:45:01+01:00]
Stid: 57ebbb10-9590-11df-a9e2-9519b5688882
Ctid: cba-9345345321

 

Copy

request:domainCHHOLDER
format:xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<registry-request xmlns="http://registry.denic.de/global/5.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:domain="http://registry.denic.de/domain/5.0" xmlns:dnsentry="http://registry.denic.de/dnsentry/5.0">
  <domain:chholder>
    <domain:handle>de-example.de</domain:handle>
    <domain:contact role="holder">DENIC-1000002-MAX</domain:contact>
    <domain:contact role="abusecontact">DENIC-1000002-ABUSE</domain:contact>
    <domain:contact role="generalrequest">DENIC-1000002-GENERAL</domain:contact>
    <dnsentry:dnsentry xsi:type="dnsentry:NS">
      <dnsentry:owner>de-example.de</dnsentry:owner>
      <dnsentry:rdata>
        <dnsentry:nameserver>ns1.xn--de-xample-x2a.de</dnsentry:nameserver>
      </dnsentry:rdata>
    </dnsentry:dnsentry>
    <dnsentry:dnsentry xsi:type="dnsentry:NS">
      <dnsentry:owner>de-example.de</dnsentry:owner>
      <dnsentry:rdata>
        <dnsentry:nameserver>ns2.de-example.de</dnsentry:nameserver>
        <dnsentry:address>81.91.170.12</dnsentry:address>
      </dnsentry:rdata>
    </dnsentry:dnsentry>
    <dnsentry:dnsentry xsi:type="dnsentry:NS">
      <dnsentry:owner>de-example.de</dnsentry:owner>
      <dnsentry:rdata>
        <dnsentry:nameserver>ns2.de-example.de</dnsentry:nameserver>
        <dnsentry:addressV6>2001:608:6:6:0:0:0:11</dnsentry:addressV6>
      </dnsentry:rdata>
    </dnsentry:dnsentry>
    <dnsentry:dnsentry xsi:type="dnsentry:DNSKEY">
      <dnsentry:owner>de-example.de.</dnsentry:owner>
        <dnsentry:rdata>
          <dnsentry:flags>257</dnsentry:flags>
          <dnsentry:protocol>3</dnsentry:protocol>
          <dnsentry:algorithm>8</dnsentry:algorithm>
          <dnsentry:publicKey>AwEAAajpN1rjU365IDVSd+duoMg4UF4S8zBSpJ4D/p2VSOKYVN7/0CkAV6pOhmdcoUMETA2LDPBWjEh4rrGiBN9ReRw/4udMgiEf3YyvsJEDpF6vtrWzqe+Cu9iu8QV//8ESlQgqK8TqVcR7e/FPd89R44S68GhZRFGw7h7sDrRnGIZf</dnsentry:publicKey>
        </dnsentry:rdata>
    </dnsentry:dnsentry>    
  </domain:chholder>
  <ctid>cba-987654321</ctid>
</registry-request>
Copy

response:domainCHHOLDER
status:connect
format:xml

<?xml version="1.0" encoding="UTF-8"?>

<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
  <tr:transaction>
    <tr:stid>538f1687-963a-11df-a9e2-9519b5688882</tr:stid>
    <tr:ctid>cba-987654321</tr:ctid>
    <tr:result>success</tr:result>
    <tr:message level="info" code="53000080013">
      <tr:text>Domain "Status" is "connect"</tr:text>
    </tr:message>
    <tr:message level="info" code="16350000041">
      <tr:text>Verification information must be provided for the holder(s) to avoid deletion by</tr:text>
      <tr:argument>2024-12-16T15:45:01+01:00</tr:argument>
    </tr:message>
    <tr:message level="info" code="16350000040">
      <tr:text>Verification information must be provided for the holder(s) to avoid dedelegation by</tr:text>
      <tr:argument>2024-12-09T15:45:01+01:00</tr:argument>
    </tr:message>
  </tr:transaction>
</registry-response
Copy

response:domainCHHOLDER
status:serverHold
format:xml

<?xml version="1.0" encoding="UTF-8"?>

<registry-response xmlns="http://registry.denic.de/global/5.0" xmlns:tr="http://registry.denic.de/transaction/5.0">
  <tr:transaction>
    <tr:stid>538f1687-963a-11df-a9e2-9519b5688882</tr:stid>
    <tr:ctid>cba-987654321</tr:ctid>
    <tr:result>success</tr:result>
    <tr:message level="info" code="53000080013">
      <tr:text>Domain "Status" is "serverHold"</tr:text>
    </tr:message>
    <tr:message level="info" code="16350000041">
      <tr:text>Verification information must be provided for the holder(s) to avoid deletion by</tr:text>
      <tr:argument>2024-12-16T15:45:01+01:00</tr:argument>
    </tr:message>
  </tr:transaction>
</registry-response